home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / offline / pgpw122a.zip / PGPWAVE.DOC < prev    next >
Text File  |  1996-01-20  |  16KB  |  352 lines
  1.  
  2. ▄████████▄  ▄██████▄ ▄████████▄    ▄█▄   ▄█▄  ▄█████▄  ▄██▄  ▄██▄ ▄███████▄
  3. ███▀   ▀██ ███▀   ▀▀ ███▀   ▀██    ███   ███ ███▀▀▀███ ████  ████ ███    ▀▀
  4. ███▄   ▄██ ███  ▄▄▄  ███▄   ▄██    ███   ███ ███▄▄▄███ ████  ████ ███▄▄▄▄▄
  5. █████████▀ ███  ▀▀██ █████████▀    ███▄█▄███ █████████ ▀███▄▄███▀ ███▀▀▀▀▀
  6. ████       ████▄▄▄██ ████          █████████ ███   ███  ▀██████▀  ███    ▄▄
  7. ▀██▀        ▀██████▀ ▀██▀           ▀█▀ ▀█▀  ▀█▀   ▀█▀    ▀██▀    ▀███████▀
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                                     by John Stephenson
  20.                                                     v1.22a Gamma
  21.                                                     Copyright 1994-95
  22.  
  23.  
  24.  
  25. Licence:
  26.  
  27.   Use at your own risk. This software is conditional freeware. There is
  28.   absolutely no charge on it for NONCOMMERCIAL uses, the unregistered
  29.   COMMERCIAL use of this program is strictly disallowed except for
  30.   evaluation of up to and NOT EXCEEDING 30 days. After 30 days the usage
  31.   of this program for COMMERCIAL purposes violates this licence, and
  32.   therefore your right to use this program.
  33.  
  34.   You are a NONCOMMERCIAL user only if you are using PGPWave as a private 
  35.   individual with no "sponsors", "backers", and only if your use is not 
  36.   making (helping to make, or intended to make) you or any affiliates a 
  37.   profit.
  38.  
  39.   You are a COMMERCIAL user if PGPWave is run by (or for) any corporation,
  40.   government, foundation, company, or any other organization.
  41.   
  42.   If you qualify as a COMMERCIAL user please see ORDER.FRM detailing the 
  43.   cost of registration.
  44.   
  45.     Once I receive the letter with the correct funds, I will then send you 
  46.     a small notice stating you are a registered user, along with a 
  47.     registration code that changes PGPWave to clearly state it is the 
  48.     commercial version. The license you receive is a SITE licence, meaning 
  49.     you can run as many copies as you wish on as many machines as you wish 
  50.     as so long as all machines are running under your same organization.
  51.  
  52. Requirements:
  53.  
  54.   You will require a 8086 or above processor. A color video card is highly
  55.   recommended, monochrome is supported. PGPWave requires XMS, EMS, or enough 
  56.   available disk space to swap to disk. In memory PGPWave should take in 
  57.   between 120k and 150k of memory. (PGPWave accolates the memory on the fly, 
  58.   so it can change quite quickly, eg reading in your tagline file can 
  59.   temporarily steal quite a lot of memory for other processes)  PGPWave 
  60.   requires your DOS to be compatible with MS-DOS 5+. You must also have 
  61.   the DOS environmental variables "TEMP" or "TMP", "TZ", and "PGPPATH" set 
  62.   correctly.
  63.  
  64. Tokens
  65. ~~~~~~
  66. Tokens are little markers saying for PGPWave to replace the tokens
  67. with special text. Tokens will work when passing filenames, or in your
  68. signature file, or taglines. They are simply an @ symbol followed by
  69. a single letter. Here is a listing of the tokens:
  70.  
  71.  @f - Message filename (lowercase)
  72.  @F - Message filename (uppercase)
  73.  @T - Current time
  74.  @t - Current time (UTC)
  75.  @D - Current date
  76.  @d - Current date (UTC)
  77.  @Z - Current timezone (uppercase)
  78.  @z - Current timezone (lowercase)
  79.  @P - Product name (in the case of a COMMERCIAL version it will report
  80.       "PGPWave/commercial")
  81.  @U - Will return your name
  82.  @V - Current version of PGPWave
  83.  @R - Current release of PGPWave
  84.  @A - Current author of PGPWave
  85.  @@ - A single "at" sign (@)
  86.  
  87. Taglines
  88. ~~~~~~~~
  89. The tagline file consists a list of single-lined taglines without the
  90. three dots that PGPWave will insert.  There are two special tokens,
  91. [altlist] and [comment] that can be used in your tagline list. If
  92. you use [comment] pgpwave will highlight the text following the tagline
  93. token, and not allow it to be selected as a tagline. If you use [altlist]
  94. PGPWave will highlight that (with a different color) and when you select
  95. it, it will will load that file, if you do not wish the file name to
  96. be displayed, but rather a name that describes what's in the file, then
  97. simply put after the end of the line the comment.
  98.  
  99. For example:
  100.  
  101. [comment]Alternate tagline lists
  102. [altlist]C:\Bwave\Sex.Tag Sex taglines
  103. [altlist]C:\Bwave\Tom.Tag Tom Swift taglines
  104. [altlist]C:\Bwave\Oxymoron.Tag Oxymoron taglines
  105. [altlist]C:\Bwave\Blondes.Tag Blonde joke taglines
  106. [altlist]C:\Bwave\Confucius.tag Confucius sayings taglines
  107.  
  108. And instead of the path being shown, only the comment will. With BlueWave
  109. it will still be able to utilize this, but the path will be shown along
  110. with the comment. In a few regards, PGPWave's tagline ability is much
  111. stronger and easier to use than Bluewave's.
  112.  
  113. There are also many other commands to manipulate your taglines, see the
  114. help from the tagline selection box for more detail.
  115.  
  116. The tokens listed in the section entitled "Tokens" will work with the
  117. taglines themselves, and will be translated and written to your message.
  118.  
  119. Signatures
  120. ~~~~~~~~~~
  121. Signatures in PGPWave are exceedingly easy to use. A signature is a small 
  122. amount of text that is automatically added to each of your messages you 
  123. write. The signature is simply a small text file, but with PGPWave this can 
  124. get a little bit more confusing because it has a few special features in it.
  125.  
  126. An example signature would be:
  127.  
  128. -------------------------- C:\PGP\PGPWAVE\MY.SIG -----------------------------
  129.  
  130.                                                                   - DarkFire
  131.  
  132. [@U (DarkFire), Fingerprint: 66BE3A3B6EEE9A5B-48001A32901ECA21]
  133. [Composed at @t on @d (UTC) using @P v@V @R]
  134. ------------------------------------------------------------------------------
  135.  
  136. Notice the tokens? They are translated when the signature is put on to
  137. the message (see "Tokens" in this manual for further information). (The
  138. signature should contain one line without a token! This is quite important,
  139. or PGPWave will not be able to autodetect if there is a signature already
  140. there and this might result in duplicate signatures if you re-edit the
  141. message)
  142.  
  143. Now, go into the setup, and switch on "Add signature to every message",
  144. and also setup the signature filename.
  145.  
  146. Now that's the most simple way to use signatures. If at different times
  147. you need different signatures, here is what you do:
  148.  
  149. In your signature file you can have it setup similar to this:
  150.  
  151. [comment]These are my signatures:
  152. [altsig]C:\PGP\PGPWAVE\NIN.SIG Nine Inch Nails conference
  153. [altsig]C:\PGP\PGPWAVE\TAGLINE.SIG Tagline conference signature
  154. [altsig]C:\PGP\PGPWAVE\NORMAL.SIG Normal signature
  155. [altsig]C:\PGP\PGPWAVE\OTHER.SIG Other signature file
  156.  
  157. The [comment] token works just like the tagline area comment token, and so 
  158. does the [altsig] work in the same manner as [altlist]. The text after the 
  159. filename is optional, and it's only purpose is to replace the filename as 
  160. the default description.  Now when you exit, you'll receive a popup menu to 
  161. select which of the possible signature is the one you wish to use.  If you 
  162. don't wish to use any of them, hit escape, if you do, go to it and hit enter.
  163.  
  164. Questions & Answers:
  165.  
  166. Q: How do I use it?
  167.  
  168. A: Simple. Install it into C:\PGP\PGPWAVE\, or a similar directory. In your 
  169.    offline reader configuration where you have your normal editor (eg for 
  170.    Bluewave: "C:\DOS\EDIT.COM @F") replace with: 
  171.    "C:\PGP\PGPWAVE\PGPWAVE.EXE @F")
  172.  
  173.    Also you might have to have swapping enabled for the editor (in the setup
  174.    under "swapping"), since PGP requires a lot of memory to correctly
  175.    operate. But, try without swapping first.  (Generally if you have 400k of
  176.    ram free when passing to PGPWave you won't ever need to swap)  Also note 
  177.    that you may have to change with the paths in the setup options, but 
  178.    PGPWave makes the best efforts to automatically find the applications 
  179.    it requires.
  180.  
  181.    NOTE: If you're not using the PGPPATH, TEMP (or TMP), and TZ environmental
  182.          variables you must set them.
  183.  
  184.    Examples are: Set TEMP=C:\TEMP
  185.                  Set TEMP=D:\
  186.                  
  187.                  Set PGPPATH=C:\PGP
  188.                  Set PGPPATH=C:\UTILS\PGP
  189.  
  190.                  Set TZ=AST4ADT (Atlantic time)
  191.                  Set TZ=EST5EDT (Eastern time)
  192.                  Set TZ=CST6CDT (Central time)
  193.                  Set TZ=MST7MDT (Mountain time)
  194.                  Set TZ=PST8PDT (Pacific time)
  195.     
  196.      If you timezone does not observe daylight savings time, then take out 
  197.      the last three letters. Eg: Set TZ=MST7 (Arizona never uses daylight 
  198.      savings time.
  199.         
  200.    You of course must set it to the correct directories/timezone. If you
  201.    live in some other timezone and are unable to find out the correct
  202.    timezone setting, it is easy to setup a fake time zone:
  203.    
  204.    Where:
  205.      XXX - is simply any three letters (normally abbreviation timezone)
  206.      Y   - is the difference in your time zone (when you're in standard time)
  207.            to UTC (formally known as Greenwich Mean Time), IE if you need to
  208.            add 5 hours to get UTC, then this value is "5". If you need to 
  209.            subtract 5 hours to get UTC, then this value is "-5".
  210.      ZZZ - is simply any three letters, and you *only* put this in if you
  211.            observe daylight savings time (you observe daylight savings
  212.            time if you adjust your clock by one hour at 2:00am on the first 
  213.            Sunday of April and at 2:00am on the last Sunday in October)
  214.            (normally abbreviation for timezone in daylight time)
  215.    Write: XXXYZZZ
  216.  
  217. Q: Then what do I do?
  218. A: Download a Qwk packet (or Bluewave<tm> packet) and enter some mail where
  219.    ever you wish. Hit "E" for enter or "R" for reply. Now the PGPWave will
  220.    appear, choose either post a key, or use the editor. You can use the arrow
  221.    keys, home, end, page down, and page up or your mouse.
  222.  
  223. Q: Okay, I've written my message in my editor (or chosen post a key, or
  224.    some other choice), now what should I do?
  225. A: Save it, then (if you wish) spell check it. Then if you feel appropriate
  226.    go to Sign, Encrypt, or Sign & Encrypt. Or simply save it if you don't want
  227.    to use any pgp features on the message.  To view the message that you've
  228.    signed (or key that you've posted) choose Editor again, and maybe add some
  229.    text to it if you feel that you should explain it some more (eg whether
  230.    it's a key etc)
  231.  
  232. Q: Now..?
  233. A: Choose save and exit (or abort and exit. Note: Abort will wipe the
  234.    message file, and will not be entered in your application, nor will
  235.    it be able to be unerased)
  236.  
  237. Q: Is this software really free when I see other shareware marked as high
  238.    as $35 (and above)?
  239. A: Yes. You can use (and abuse) this software for any NONCOMMERCIAL
  240.    purpose. If you wish to see any customizations for yourself (eg new
  241.    features that would not be suitable for every ones use, different
  242.    options, different handling) see ORDER.FRM for the form to send me,
  243.    and in the additional information detail the specific aspects for
  244.    you. I may not be able to design the features you may require, so I
  245.    recommend you send me netmail or a voice phone call telling me about
  246.    what you wish to see added for your specific purpose. Once the changes
  247.    are complete, I will send the finished program to you ASAP.
  248.  
  249. Q: Is the source code available, if so, is it available for free?
  250. A: Yes, no. Full source code is available for a small sum of money. (see 
  251.    ORDER.FRM) I believe in not charging for the use of this work, in the 
  252.    spirit of PGP, but I can't justify releasing the source code to the 
  253.    application. In case you're wondering, PGPWave is written using Borland 
  254.    Pascal v7.0, and the source including my units, comes to around one 
  255.    hundred thousand lines of code.
  256.  
  257. Q: I'm sick of typing yes to save etc, is there a better way?
  258. A: Yes. Hit escape twice at the main menu. This will exit, then go with the
  259.    default answer to quitting (yes).
  260.  
  261. Q: Okay, I know that I can steal a tagline from Bluewave while reading the
  262.    message, but what if I see a tagline inside of the encrypted message, or
  263.    I just realize that it's actually worth stealing?
  264. A: After decrypting, or any time in fact, go to view a message then press
  265.    Alt A. There's also help the view a message in case you get stuck.
  266.  
  267. Q: My offline reader, or message reader doesn't support taglines or nice
  268.    signatures, and I really think they're neat. What should I do?
  269. A: Simple. PGPWave supports automatic tagline adding, and signatures.
  270.    Simply set the Tagline path to a file that lists one-liner taglines
  271.    without the "..." part, and then enable the "auto add tagline" in 
  272.    the setup menu to "yes". When you're finished with a message you simply 
  273.    exit as usual and it will come up with a tagline prompt. If you do 
  274.    not wish to use taglines, then hit escape, else move to the tagline
  275.    you wish using your arrow keys, then select with enter, or space. 
  276.    If you wish to randomly choose a tagline, then use F8, or F9. F9
  277.    will randomly choose a tagline for you without confirmation. F8
  278.    will just jump to a random tagline, but not select it. F10 allows
  279.    you to make up your own tagline, the default for F10 will be the
  280.    current tagline, ie if you just wish to modify it.
  281.     
  282. Q: I get to a string prompt, and there's a default there. I don't wish
  283.    to hold down my backspace key because that time will be extremely
  284.    valuable time lost off of my life. What can I possibly do?
  285. A: With all input fields, Control Y will clear the field instantly.
  286.  
  287. Q: Can PGPWave be used with anything other than Bluewave?
  288. A: Yes. I've personally seen it work with other msg utilities, eg GoldEd and
  289.    the BBS Maximus, and every offline reader that allows an external text 
  290.    editor can use this.  Plus it will allow you to add taglines etc if the 
  291.    offline read you're using doesn't support them. The colours are also 
  292.    customizable.
  293.  
  294. Q: Okay, this is great software, I understand that it's freeware, but is there
  295.    anything I can do to help you out if I'm not a COMMERCIAL user?
  296. A: Actually no, but next Christmas if you see a salvation army donation pot
  297.    please drop in a dollar. Consider it a donation of good faith, and no..
  298.    I don't believe in God, but I think it's an excellent charity.
  299.  
  300. Q: So now what?
  301. A: Enjoy it you fool! :-)
  302.  
  303.    My support BBS is:
  304.  
  305.       Serpent's Egg
  306.       1:249/146.0
  307.       613-547-3851
  308.       Kingston, Ontario
  309.       Canada.
  310.    
  311.    The latest version of PGPWave is also usually available from this BBS:
  312.  
  313.      Rights On!
  314.      1:374/14.0
  315.      407-383-1372
  316.      Titusville, Florida
  317.      USA.
  318.  
  319.    PGPWave on all three systems can be file requested as "PGPWAVE". The
  320.    filenaming convention is: "PGPWxxxy.ZIP" (where xxx is the version, y
  321.    is the release) All three systems either have Guest accounts, or
  322.    first time downloads. Please read over the intro screens of each BBS
  323.    to see if a Guest account is setup.
  324.  
  325.    To reach me, send me Netmail to Serpent's Egg, if that's not an
  326.    option you can call directly and leave mail to me. Or leave internet
  327.    email to darkfire@serpents.crp.kingston.on.ca
  328.  
  329.    If it's an emergency (note the word just before the left bracket again),
  330.    you can give me a ring at 613-542-1239 (house line) I will not accept
  331.    collect calls (just remember this is a freeware product..), and if it's
  332.    a serious enough bug I should be able to have a bug fix available within 
  333.    a week, possibly sooner. Commercial users will have precedence over 
  334.    freeware users.
  335.  
  336.    I also have a mailing address:
  337.  
  338.      John Stephenson
  339.      Po Box 1573
  340.      Kingston, Ont
  341.      Canada, K7L 5C8
  342.  
  343. Due recognition: To Ralf Brown for writing Spawno (Pascal implementation)
  344.  
  345. Copyright 1994,1995.
  346.  
  347. Revisions dating from Sunday August 21st 1994 to Saturday December 24th 1995.
  348.  
  349.                                                                   - DarkFire
  350.  
  351. John Stephenson (DarkFire), Fingerprint: 66BE3A3B6EEE9A5B-48001A32901ECA21
  352.